home *** CD-ROM | disk | FTP | other *** search
/ Reverse Code Engineering RCE CD +sandman 2000 / ReverseCodeEngineeringRceCdsandman2000.iso / RCE / Library / +ORC / Orc pac 9A / FILEZ.ZIP / SICE3'95.ZIP / setup.Z / README.TXT < prev    next >
Encoding:
Text File  |  1996-11-25  |  10.9 KB  |  308 lines
  1.  
  2. README.TXT
  3.  
  4. SoftICE 3.0 Release Notes
  5.  
  6.  
  7. -----------------------------------------------------------------
  8.                         Table Of Contents 
  9. -----------------------------------------------------------------
  10. * What's New in SoftICE 3.0
  11. * System Requirements
  12. * Installation
  13. * Using SoftICE On A Multi-Processor System
  14. * Quick Start to Debugging
  15. * VToolsD Support
  16. * DOS Extender Support (Windows NT Only)
  17. * Known Anomalies
  18. * Troubleshooting Tips
  19. * Reporting Problems And Suggestions
  20.  
  21.  
  22. What's New in SoftICE 3.0
  23. --------------------------------
  24.  
  25. SoftICE 3.0 is available separately for Windows 95 and Windows NT. Many 
  26. enhancements apply to both versions of SoftICE, while others are new 
  27. only to the Windows 95 version.
  28.  
  29. For Windows 95 and Windows NT
  30.  
  31. We know you'll like these major enhancements:
  32.  
  33. * Locals and structures support
  34. * One-step Symbol Loader(no more DBG2MAP and MSYM)
  35. * Mouse support
  36. * On-line Command Reference and Using SoftICE manuals
  37.  
  38. Read "What's New in SoftICE 3.0" (WHATSNEW.DOC) for a quick tour and 
  39. refer to your SoftICE manuals for details.
  40.  
  41. Locals and structures support, and the new Symbol Loader (LOADER32.EXE) 
  42. are designed for debugging Windows programs only. The old utilities are 
  43. available in UTIL16 for debugging MS-DOS programs.
  44.  
  45. For Windows 95
  46.  
  47. We updated the Windows 95 version of SoftICE to include features we 
  48. originally introduced for Windows NT. Highlights include:
  49.  
  50. * Automatic VM Switching, with context or VM displayed on the status bar
  51. * New SoftICE Expression Evaluator
  52. * Conditional breakpoints and breakpoint actions
  53. * Macros
  54. * New QUERY command to display the virtual address map of a process
  55. * New WHAT command to analyze names and expressions
  56.  
  57. "What's New in SoftICE 3.0" lists the command changes for Windows 95.
  58.  
  59.  
  60. System Requirements
  61. -------------------
  62.  
  63. For All Systems:
  64.  
  65. * 5 MB disk space required
  66. * 2.5 MB disk space optional (Adobe Acrobat Reader for on-line manuals)
  67. * Microsoft-compatible Serial or PS/2 mouse (optional)
  68. * Single monitor, an additional monochrome monitor, and remote debugging 
  69. are supported
  70.  
  71. For Windows 95:
  72.  
  73. * Windows 95
  74. * 16 MB RAM minimum (32 MB recommended)
  75.  
  76. For Windows NT:
  77.  
  78. * Intel x86 uniprocessor system (or single CPU on an SMP system)
  79. * Windows NT 3.51
  80. * Windows NT 3.51 with NewShell
  81. * Windows NT 4.0 (Build 1381)
  82. * 32 MB RAM minimum (64 MB recommended)
  83. * Installation account with administrator rights
  84.  
  85.  
  86. Installation
  87. ------------
  88.  
  89. * To install SoftICE, run SETUP.EXE. For Windows NT, run Setup from an 
  90. account with administrator rights.
  91.  
  92. * Setup will prompt you to select your display adapter's make and model, 
  93. and allow you to set up an additional monochrome monitor.
  94.  
  95. * Setup will prompt you to select the type of mouse you are using (none, 
  96. serial-COM1, serial-COM2, or PS/2). The bus mouse is not supported.
  97.  
  98. * You can change your display adapter or mouse later by running Display 
  99. Adapter or Mouse Setup from the SoftICE start menu (Windows 95) or the 
  100. SoftICE program group (Windows NT).
  101.  
  102. * For Windows NT only: Setup will prompt you to select a startup mode 
  103. for SoftICE. You can change your startup mode later by running Startup 
  104. Mode Setup from the SoftICE program group.
  105.  
  106. * To uninstall SoftICE, select Remove SoftICE from the SoftICE start 
  107. menu (Windows 95) or from the SoftICE program group (Windows NT).
  108.  
  109.  
  110. Using SoftICE On A Multi-Processor System
  111. -----------------------------------------
  112.  
  113. SoftICE 3.0 supports using a single CPU on a multi-processor system, but 
  114. does not provide full SMP support. To boot an SMP machine using only one 
  115. CPU copy the boot.ini line that boots your version of NT and add the 
  116. /onecpu switch onto the end of the line. Boot.ini is normally a hidden, 
  117. read-only system file.
  118.  
  119. Example:
  120.  
  121. If the following line starts Windows NT 3.51:
  122.  
  123. multi(0)disk(0)rdisk(0)partition(1)\winnt="Windows NT Workstation 
  124. Version 3.51"
  125.  
  126. Copy it and change the new line as follows to start NT 3.51 using only 
  127. one CPU:
  128.  
  129. multi(0)disk(0)rdisk(0)partition(1)\winnt="Windows NT Workstation 
  130. Version 3.51 (one CPU)" /onecpu
  131.  
  132.  
  133. Quick Start to Debugging
  134. ------------------------
  135.  
  136. 1) Run Symbol Loader (LOADER32.EXE).
  137.  
  138. 2) Choose File-Open Module, and select the module you want to debug.
  139.  
  140. 3) Choose Module-Load (or click the Load button on the toolbar). SoftICE 
  141. automatically extracts symbol information from your module, creates a 
  142. .NMS file containing the information, loads the symbols and source code, 
  143. and, if you are loading an EXE file, loads the EXE and sets a 
  144. breakpoint. You're ready to start debugging.
  145.  
  146. Other features to check in the new symbol loader:
  147.  
  148. * Module-Settings (symbol translation and debug options for your module)
  149. * Module-Translate (creates a .NMS file for pre-loading at start up)
  150. * Edit-SoftICE Initialization Settings (replaces WINICE.DAT)
  151. * File-Load Exports (loads exported symbols for DLLs you select)
  152. * File-Save SoftICE History (replaces WLOG and DLOG)
  153.  
  154.  
  155. VToolsD Support
  156. ---------------
  157.  
  158. SoftICE 3.0 adds support for locals and structures, which makes it 
  159. easier than ever to develop VxDs in C/C++. To take full advantage of 
  160. SoftICE 3.0, VToolsD users will need to make some minor modifications to 
  161. the VtoolsD make files.
  162.  
  163. Microsoft Visual C++ users:
  164.  
  165. Edit vtd95\include\ms9.mak as follows:
  166.  
  167. 1) Replace all instances of /Zxx (where xx can be anything) with /Zi. 
  168. This ensures that full debug information is included.
  169.  
  170. 2) Remove references to DBG2MAP and MSYM. Those tools were used with 
  171. older versions of SoftICE but are now obsolete. Instead, to create your 
  172. .NMS symbol file, use:
  173.  
  174. NMSYM /PROMPT /TRANSLATE:package,always 
  175. /SOURCE:$(VTOOLSD)\lib\source;$(VTOOLSD)\lib\classlib;$(VTOOLSD)\lib\include $(TARGNAME)
  176.  
  177. Unzipping the VtoolsD source code is recommended for full source-level 
  178. debugging.
  179.  
  180. Borland C++ users:
  181.  
  182. 1) Build your VxD with debug information using the /v switch for the 
  183. compiler and linker (as usual).
  184.  
  185. 2) Use the PELE utility with the -s switch to create a section mapping 
  186. file (.SMF). Translate the .SMF file to a .NMS symbol file with LOADER32 
  187. or NMSYM. Note that translating the .DLL produced by the linker will not 
  188. work; it is essential to translate from the .SMF file.
  189.  
  190. NOTE:
  191. NuMega plans to make replacement makefiles incorporating these changes 
  192. available from the technical support section of our Web site 
  193. (www.numega.com).
  194.  
  195.  
  196. DOS Extender Support (Windows NT Only)
  197. --------------------------------------
  198.  
  199. You can debug DOS Extender applications with SoftICE, but the process is 
  200. not as automatic as with Windows applications. Be aware of the following 
  201. points:
  202.  
  203. * To gain control in the beginning of your application, embed an int 3 
  204. instruction in your code and turn i3here on in SoftICE.
  205.  
  206. * Both sticky and virtual breakpoints are not supported in extender 
  207. applications.
  208.  
  209. * You can debug 32-bit extender applications at source level if your 
  210. tools are capable of producing debug information compatible with the 
  211. DBG2MAP utility. Use the utilities in UTIL16 for DOS extenders.
  212.  
  213. * Symbols are not automatically repaired. Use the SYMLOC command to set 
  214. both the base address and context for your application.
  215.  
  216.  
  217. Known Anomalies
  218. ---------------
  219.  
  220. * When debugging 16-bit programs, expanding pointers to structures in 
  221. the Locals and Watch window is not supported. The data displayed when 
  222. the structures expand is not valid.
  223.  
  224. * The NT 3.51 checked build crashes when SoftICE is loaded using the 
  225. default winice.dat file. To fix the problem, change winice.dat as 
  226. follows:
  227. - Add the line: mouse=off
  228. - If you are using a mouse in SoftICE, add "set mouse on" to your INIT 
  229. string. Example: init="set mouse on;X;"
  230.  
  231. * SoftICE 3.0 in Windows 95 is not compatible with BoundsChecker for 
  232. Windows 3.x (16-bit). If you need to run SoftICE with 16-bit 
  233. BoundsChecker, use SoftICE 2.0, or check our web site to see if a patch 
  234. is available.
  235.  
  236. * The Windows 95 shutdown option Restart computer in MS-DOS mode is not 
  237. supported when running SoftICE. Loading SoftICE after choosing this 
  238. option causes the system to become unstable and eventually crash. To 
  239. return to MS-DOS after you shut down Windows 95, set BOOTGUI=0 in 
  240. MSDOS.SYS (really an ini file with hidden, read-only, system 
  241. attributes). Then use Shutdown the Computer to restart your system.
  242.  
  243. * Windows NT becomes unstable when it runs low on non-paged memory. This 
  244. can occur if you load many symbols and source files. Use Symbol Loader-
  245. Help-About Symbol loader to monitor SoftICE memory usage. You may need 
  246. to be selective about how much information you load into SoftICE. 
  247. SoftICE loads all source files by default. To limit the source files, 
  248. list the files to be loaded in a .SRC file with the same name as your 
  249. module. Put the .SRC file in the same directory with your executable.
  250.  
  251.  
  252. Troubleshooting Tips
  253. --------------------
  254.  
  255. * Erratic keyboard behavior:  If the keyboard behaves erratically when 
  256. you load SoftICE, run Symbol Loader, select Edit-SoftICE Initialization 
  257. Settings, and select the following option on the Troubleshooting page, 
  258. and restart SoftICE:
  259.  
  260. --- Disable Num Lock and Caps Lock programming
  261.  
  262. If the erratic behavior persists in Windows NT, select this 
  263. Troubleshooting option as well:
  264.  
  265. --- Do not patch keyboard driver
  266.  
  267. * Erratic mouse pointer movement: If mouse movement occurs when SoftICE 
  268. pops up, the operating system and the mouse hardware might become out of 
  269. sync because part of a mouse packet is lost. This results in erratic 
  270. mouse pointer movement. Use one of the following to resync the mouse:
  271. - Type ctrl-M in SoftICE. You may need to do this a few times.
  272. - Switch to a full screen DOS box in Windows NT.
  273. - Use SET MOUSE OFF, followed by SET MOUSE ON, in Windows 95.
  274.  
  275. *If you encounter a situation where either program logic or a corrupt 
  276. data structure causes SoftICE to enter an endless loop and the 
  277. informational commands do not respond in a timely manner, press the 
  278. Escape (Esc) key one or more times to abort the current operation.
  279.  
  280. * Debugging Delphi Programs - Be sure to use the $O- option to turn off 
  281. optimizations. When optimizations are on, many unreferenced parameters 
  282. and locals are optimized out, although some reference to them still 
  283. exists in the debug information.
  284.  
  285.  
  286. Reporting Problems And Suggestions
  287. ----------------------------------
  288.  
  289. Be sure to check our web site at http://www.numega.com for product 
  290. updates, FAQs, white papers and other technical support information.
  291.  
  292. Contact Technical Support through e-mail at support@numega.com or by 
  293. calling Technical Support at 603-889-2386. You can also FAX us at 
  294. 603-889-1135 (attention: Technical Support).
  295.  
  296. Include the following in your problem report:
  297.  
  298. * System Configuration (O/S, processor, and RAM)
  299. * Detailed problem description (include exact error message text)
  300. * How to reproduce the problem
  301.  
  302.  
  303.  
  304.  
  305. -----------------------------------------------------------------
  306. Copyright 1996 NuMega Technologies, Inc.
  307. 11/22/96
  308.